home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / c / sysihack.doc < prev    next >
Text File  |  1996-09-07  |  7KB  |  164 lines
  1.  
  2.    NAME
  3.     sysihack - sysiclass hack 0.6 (14.7.94)
  4.  
  5.     sysiclass is the BOOPSI class for system images, such as window
  6.     gadgets and menu symbols.
  7.  
  8.    WARNING
  9.     This is an ALPHA version.  Do not use it, unless you really know
  10.     what you do!
  11.  
  12.    FUNCTION
  13.     Hacks sizing gadget and scroll arrows to look nice in 1:1 screens.
  14.     Requires a font >= 11 pt, and a highres 1:1 aspect screen.
  15.  
  16.    REQUIRES
  17.     WB 3.0.  (Even works with 2.x, but only 3.0 is resolution adaptive).
  18.     Check aminet:dev/src/ScrollerWindow.lha to learn how to create
  19.     a resolution adaptive window.
  20.  
  21.    AUTHOR
  22.     Mr. BOOPSI
  23.  
  24.    STATUS
  25.     This is Public Domain.
  26.  
  27.    OPTIONS
  28.     SWIDTH/N,SHEIGHT/N,AWIDTH/N,AHEIGHT/N,
  29.     CWIDTH/N,HBORDER/N,VBORDER/N,3DLOOK/S
  30.  
  31.     SWIDTH: width of the sizing gadget (min: 18, default: 18, max: 32).
  32.     SHEIGHT: height of sizing gadget (min: 10, default: 16, max: 32).
  33.     AWIDTH: width of left/right arrows (min: 14, default: 18, max: 32).
  34.     AHEIGHT: height of up/down arrows (min: 11, default: 15, max: 32).
  35.     CWIDTH: width of 3D close gadget (min: 14, default: 20, max: 28).
  36.     HBORDER: height of bottom border (min: 2, default: 4, max: 10).
  37.     VBORDER: width of vertical borders (min: 2, default: 4, max: 18).
  38.     3DLOOK: 3D look (XEN style) gadgets.
  39.  
  40.    INSTALLATION
  41.            ****************************************************
  42.     Put it ***** BEFORE IPrefs in your S:Startup-sequence *****, e.g:
  43.            ****************************************************
  44.     (Arrgh, why do people NEVER read the docs???  Is it clear now? ;)
  45.  
  46.     C:sysihack 18 10 18 11        ; original sizes (but may use 3DLOOK)
  47.     C:sysihack 18 14 16 13        ; best look with 11 pt font or NTSC
  48.     C:sysihack 18 16 18 15        ; 13 pt font
  49.     C:sysihack 20 18 20 17        ; 15 pt font
  50.  
  51.     You got the picture, right?  A future version will perhaps do size
  52.     selections automatically, but I need the options for quick testing.
  53.  
  54.     If it complains that it hasn't been started before IPrefs, move it
  55.     up.  Probably best thing to do is to start it right after SetPatch.
  56.     No screen may be open if sysihacks starts.
  57.  
  58.    NOTES
  59.     If you set the 3DLOOK option, the look of the windows will NOT conform
  60.     to the standards described in the Amiga User Interface Style Guide.
  61.     If you don't like this, don't use it.
  62.  
  63.     The little 'hole' in the prop gadgets will only appear with BOOPSI
  64.     propgclass objects.  For compatibility, no subclasses of propgclass
  65.     are supported here.
  66.  
  67.     Default sizes do only look good with a 13 pt font, so you WILL need
  68.     to adjust sizes to make it look better with e.g. an 11 pt font.
  69.  
  70.     NTSC users will probably be happier with `18 14 18 13', and HBORDER
  71.     set to 3.  Play with the values to see which you find satisfying.
  72.  
  73.     If you have a very big font (e.g. 18 pt), you can make the close
  74.     gadget bigger with CWIDTH.  24 pixels match the size of the depth
  75.     gadget.  This only works when used with the 3DLOOK option.
  76.  
  77.     HBORDER/VBORDER do not work on the Workbench screen with OS 2.0.
  78.  
  79.    CHANGES
  80.     0.6 (14.7.94):
  81.     - OOPS!  Fixed a very stupid bug in the CloseScreen() patch.  It
  82.       caused the machine to lock up if screens were closed not in the
  83.       reverse order as they were openend.  Sorry for any inconvience.
  84.     - Added additional message protection in the startup.
  85.  
  86.     0.5 (13.7.94):
  87.     - 3DLOOK now works with more programs (I patch NewModifyProp), and
  88.       also gives the XEN style 3D looking window and screen gadgets.
  89.     - Major!  No longer replaces the sizing gadget!  After I found out
  90.       that Intuition uses buttongclass to create the sizing gadget, I
  91.       thought it might be better to patch this class, instead of faking
  92.       a sizing gadget.  I was going to patch buttongclass anyway.
  93.       This has a few downsizes:
  94.       - you can no longer make the sizing gadget smaller than originally
  95.       - windows opened with OpenWindow() will look strange, because the
  96.         sizing gadget doesn't make more room in the borders
  97.       The advantages, however, by far outweight the disadvantages:
  98.       - no longer fiddles around with zoom gadgets, like it did before
  99.       - the sizing gadget is now the real one, so any and all problems
  100.         should be gone!
  101.     - No longer needs to be RUN, auto-detaches instead.  It also checks
  102.       if it was started early enough.
  103.     - Now works with all fonts >=7pt, as well as Hires-nonlaced screens.
  104.       The options are only used for fonts >= 11pt.  When the font is
  105.       smaller, default values are used.  For 8pt fonts, the values match
  106.       the original sizes.
  107.     - Horizontal scrollbars now get the required height automatically.
  108.       This is to support people who already did adaptive layout.
  109.     - New option for width of close gadget.  Only works with 3D look.
  110.     - 3D look scrollbars now get the XEN style recessed frame, when the
  111.       3DLOOK option is specified.
  112.     - HBORDER/VBORDER option added.  Specify large values, to see which
  113.       programs use hardcoded values, or use screen->WBorXXX.
  114.     - Cute looking XEN style 'hole' in propgclass scrollbars.  Thanks
  115.       to all who mailed me pictures with their suggestions!  I hope you
  116.       like it!
  117.  
  118.     0.4 (8.7.94):
  119.     - The sizing gadget is now marked as being allocated by Intuition
  120.       (even it isn't), so that programs don't try to free it.  Isn't
  121.       really critical, because I unlink the gadget before CloseWindow()
  122.       gets to see the gadget list.
  123.     - All images are now rendered into a bitmap cache for fast redraw.
  124.     - Fixed some rendering bugs, that didn't show up when the images are
  125.       used in window borders.
  126.     - 3DLOOK option temporarily removed, it hasn't worked anyway.
  127.     - Sizing gadget is now a BOOPSI buttongclass object, in case someone
  128.       relies on this.  ROM code also uses BOOPSI.
  129.     - Many internal changes for future versions ;)
  130.  
  131.     0.3 (5.7.94):
  132.     - Changed the switch() in the taglist parser to a chain of if() to
  133.       work around a compiler bug.
  134.     - Fixed GZZ windows (SuperBitmap etc.).
  135.     - Added a WaitBlit() before FreeMem()...
  136.     - Fixed Enforcerhit, if window failed to open.
  137.  
  138.     0.2 (5.6.94):
  139.     - Now also detects (direct) subclasses of propgclass for patching.
  140.     - Improved the check wether a propgadget is a border scroller
  141.       (I now just rely on the GACT_BORDER flags, only lame coders forget
  142.       to set these).
  143.     - Does no longer shrink non-AUTOKNOB hscrollers.
  144.     - Didn't verify shell args correctly.
  145.     - Fixed oldlook/monochrome left/right arrow images.
  146.     - Didn't set WFLG_SIZEGADGET flag.
  147.     - New option to force 3D-look scrollers.
  148.  
  149.     0.1 (3.6.94):
  150.     - Fixed height of hscroller on window closing (ADPro).
  151.     - Now also looks at nw->Screen and nw->Type to find screen.
  152.     - Changes up/down arrow images.
  153.     - Sizegadget now gets the SHINEPEN fill (my first AreaDraw code :)
  154.     - Changes scrollbar gaps.
  155.     - Fixed 0/0 MinWidth/MinHeight bug.
  156.     - Now longer adjusts WA_Height.  They should do that themself!
  157.     - Allows me to patch non-AutoAdjust windows (ReqTools).
  158.     - Removed startup code.
  159.     - Added a bit config ;)
  160.  
  161.     0.0 (25.5.94):
  162.     - Created and released.
  163.  
  164.